home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / Libraries / CW GUSI 1.6.4 / README.CWGUSI < prev   
Text File  |  1995-04-23  |  2KB  |  68 lines
  1. Welcome to GUSI for CodeWarrior!
  2.  
  3. This file is intended to provide a minimum of documentation to supplement the standard 
  4. documentation and README.
  5.  
  6. INSTALLATION
  7.  
  8. Basically, you need to be able to access the "Lib" and "includes" folders. This is probably 
  9. easiest done by placing aliases to these folders in the appropriate places or adding them
  10. with "Preferences…" to the "Access Paths" of your project. Be careful, though, that GUSI 
  11. headers are searched *before* the standard ANSI headers. In particular, stat.h is not
  12. compatible between the ANSI headers and GUSI.
  13.  
  14. BUILDING PROGRAMS WITH GUSI
  15.  
  16. - Your 68K programs need to be built with 4 byte ints. 
  17. - Be *very* careful about the order of libraries! GUSI does its work by overriding standard 
  18.   library routines, so it should always be first in your link order.
  19. - Dont't forget to include "GUSI Resources" or include "GUSI.r" in your own resource file.
  20. - When in doubt, look at the examples.
  21. - Templates for GUSI projects are in the Lib folder (am I not considerate?) as 
  22.  
  23.     GUSI.PPC.¶
  24.     GUSI.68K.¶
  25.     
  26. - The #1 reason for crashing GUSI clients is forgetting calls to GUSISetup()!
  27. - The #2 reason is forgetting calls to InitGraf().
  28.  
  29. PRECOMPILED HEADERS
  30.  
  31. There are two sets of precompiled headers; one is generated by GUSI.pch in the CWGUSI folder,
  32. the other by GUSITest.pch in the :CWGUSI:Examples folder. Neither is intended to be used
  33. by your programs, but only for rebuilding the libraries, and for space reasons, neither is
  34. included with GUSI. They will be rebuilt if you build GUSI.*.µ or GUSITest.*.µ 
  35.  
  36. In your own projects, either use MacHeaders or define your own precompiled headers.
  37.  
  38. REBUILDING THE LIBRARIES
  39.  
  40. To rebuild the libraries, do the following:
  41.  
  42.  - Open GUSI.PPC.µ or GUSI.68K.µ
  43.  - Choose "Make"
  44.  
  45. BUILDING EXAMPLES
  46.  
  47. To build any of the included examples, do the following:
  48.  
  49.  - Open GUSITest.PPC.µ or GUSITest.68K.µ
  50.  - Choose "Make"
  51.  - Open the project file of the example you want to build
  52.  - Choose "Make" or "Run".
  53.  
  54. MISSING SOURCE CODE
  55.  
  56. I currently believe that I can't distribute the source code to the functions to fdopen() and
  57. fwalk() without infringing on my license, therefore they are only provided in binary form.
  58.  
  59. ACKNOWLEDGEMENTS
  60.  
  61. This port would never be remotely in the shape it is now without the outstanding support of
  62. Greg Galanos, Ron Liechty and Berardino Baratta of Metrowerks.
  63.  
  64. QUESTIONS?
  65.  
  66. Ask me, Matthias Neeracher <neeri@iis.ee.ethz.ch>
  67.  
  68.